🎖️GitЯра🎖️
docs/lt-rLT/user/connections.md renovate/net.java.dev.jna-jna-5.x (5a8f4966) Text, 4.33 KB
---
title: Connections
parent: User Guide
nav_order: 2
last_updated: 2026-05-20
description: Connect your phone or desktop to a Meshtastic radio via Bluetooth, USB, or TCP/IP.
aliases:
Tff7b72- bluetooth
Tff7b72- usb
Tff7b72- tcp
Tc9d1d9 - pairing
Tc9d1d9---
Tc9d1d9# Connections
Meshtastic supports multiple transport methods to communicate between your phone/desktop and a radio node.
Tc9d1d9## Bluetooth (BLE)
Bluetooth Low Energy is the default and most common connection method on Android.
Tc9d1d9### Pairing a Device
Tff7b721. Ensure your Meshtastic radio is powered on and in pairing mode.
Tff7b722. Open the app and navigate to the **Connect** tab.
Tff7b723. Tap **Scan for Devices** — nearby Meshtastic radios will appear.
Tff7b724. Select your device from the list.
Tff7b725. Accept the Bluetooth pairing prompt if shown.
You can filter devices by transport type using the filter chips at the top:
Tff7b72> 💡 **Tip:** If your device doesn't appear, check that Bluetooth and Location permissions are granted, and that the radio is not already connected to another device.
Tc9d1d9### Connection Status
| Icon | State | Aprašymas |
| ---- | -------------- | ----------------------------- |
| 🟢 | Connected | Active radio link established |
| 🟡 | Connecting | Handshake in progress |
| 🔴 | Atsijungta | No active connection |
| ⚪ | Not configured | No device selected |
When connecting, a status indicator shows the current connection state:
If no devices are found, the app shows an empty state with instructions:
Tc9d1d9### Troubleshooting Bluetooth
Tff7b72- **Device not found:** Toggle Bluetooth off/on, ensure location is enabled.
Tff7b72- **Connection drops:** Move closer to the radio; check for interference.
Tff7b72- **Pairing rejected:** Forget the device in Android Bluetooth settings and retry.
Tc9d1d9## USB Serial
USB connections provide a wired alternative, useful for desktop or when Bluetooth is unavailable.
Tc9d1d9### Setup
Tff7b721. Connect your radio via USB cable to your device.
Tff7b722. The app will prompt for USB permission — tap **Allow**.
Tff7b723. The connection is established automatically.
Tff7b72> ⚠️ **Note:** USB connections require OTG support on Android devices.
Tc9d1d9## TCP/IP (WiFi)
Some Meshtastic radios support WiFi connectivity, allowing TCP-based connections.
Tc9d1d9### Configuration
Tff7b721. Connect your radio to a WiFi network via the radio's web interface or settings.
Tff7b722. In the app, go to **Connect → TCP**.
Tff7b723. Enter the radio's IP address and port (default: 4403).
Tff7b724. Tap **Connect**.
When a device is found, it appears in the connection list:
A successful connection is confirmed with a status indicator:
Tc9d1d9### When to Use TCP
Tff7b72- Radio is on the same local network
Tff7b72- Testing with a simulated radio
Tff7b72- Environments where Bluetooth has interference issues
Tc9d1d9## Reconnection Behavior
The app reconnects to the **last selected device** on startup. You can switch transports from the Connect screen at any time.
To disconnect, tap the disconnect button on the Connect screen:
Tc9d1d9## Desktop Connections
On Desktop (Linux/macOS/Windows), the app supports:
Tff7b72- **Bluetooth (BLE)** — via the Kable library; works on macOS, Linux, and Windows
Tff7b72- **USB Serial** — primary wired connection method
Tff7b72- **TCP/IP** — for network-connected radios
See [Tff7b72Desktop App](Te6edf3desktop) for platform-specific details and keyboard shortcuts.
Tc9d1d9## Related Topics
Tff7b72- [Tff7b72Getting Started](Te6edf3onboarding) — first-launch setup and permissions
Tff7b72- [Tff7b72Settings — Radio & User](Te6edf3settings-radio-user) — Bluetooth and network configuration
Tff7b72- [Tff7b72Desktop App](Te6edf3desktop) — desktop-specific connection details
Tff7b72- [Tff7b72Supported devices](Te6edf3https://meshtastic.org/docs/hardware/devices) — full list of compatible radios on meshtastic.org
---
Served by rngit 1.5.0 - Generated in 0.07s